home *** CD-ROM | disk | FTP | other *** search
/ Aminet 12 / Aminet 12 (1996)(GTI - Schatztruhe)[!][Jun 1996].iso / Aminet / util / time / clockdaemon.readme < prev    next >
Text File  |  1996-05-05  |  7KB  |  209 lines
  1. Short:    V1.2: hardware clock at GMT util
  2. Author:   pueschel@imsdd.meb.uni-bonn.de
  3. Uploader: pueschel@imsdd.meb.uni-bonn.de
  4. Type:     util/time
  5.  
  6. ClockDaemon 1.2
  7.  
  8.  
  9. Features:
  10. ---------
  11.  
  12.  - Keeps your hardware clock at GMT (for NetBSD users).
  13.  - Patches battclock.resource so that reads and writes to the hardware
  14.    clock are transparently adjusted.
  15.  - Handles daylight savings time.
  16.  - Does not need ixemul.library.
  17.  - Sets IXGMTOFFSET for ixemul.library V 42+.
  18.  
  19.  - NEW ! Detects DST start & end while computer is running.
  20.  - NEW ! Optionally runs command when DST begins or ends.
  21.  - NEW ! DSTCheck program for use in scripts.
  22.  
  23. Installation:
  24. -------------
  25.  
  26. Copy ClockDaemon and DSTCheck to C:, and add "run >NIL: ClockDaemon <command>"
  27. to your User-Startup, where <command> is a program you want to be executed when
  28. daylight savings time begins or ends. Store an appropriate (see below) timezone
  29. string in ENVARC:TZ.
  30.  
  31. ClockDaemon will set the IXGMTOFFSET variable for ixemul.library V 42 or
  32. higher. Do not use ixtimezone !
  33.  
  34. Reboot and reset your clock to your local time via the Time preferences
  35. program.
  36.  
  37. Since version 1.2, ClockDaemon notices the start or end of daylight savings
  38. time regardless if your computer is running at that time or not. (If it is not
  39. running, the change command will be executed the next time it is switched on.)
  40.  
  41. ATTENTION: The command you want to have executed must terminate or ClockDaemon
  42.            will hang !
  43.  
  44. Example (for Germany):
  45. ----------------------
  46.  
  47. User-Startup:
  48.  
  49. run >NIL: ClockDaemon "avail flush" ; to adapt ixemul.library to new DST setting
  50.  
  51.  
  52. ENVARC:TZ:
  53.  
  54. MET-1MEST,M3.5.0,M9.5.0/03
  55.  
  56.  
  57. DSTCheck:
  58. ---------
  59.  
  60. The DSTCheck command gives you an easy way to check the DST status in CLI
  61. scripts. Its return status is WARN (5) during DST, OK (0) otherwise.
  62.  
  63. Example:
  64.  
  65. DSTCheck
  66.  
  67. If Warn
  68.   Echo "We have DST !"
  69. Else
  70.   Echo "We don't have DST !"
  71. Endif
  72.  
  73. Timezone strings:
  74. -----------------
  75.  
  76. This is a description of valid timezone strings for ENV[ARC]:TZ:
  77.  
  78. "XPG3TZ - time zone information"
  79.  
  80. The form of the time zone information is based on the XPG3 specification of
  81. the TZ environment variable.  Spaces are allowed only in timezone
  82. designations, where they are significant.  The following description
  83. closely follows the XPG3 specification, except for the paragraphs starting
  84. **CLARIFICATION**.
  85.  
  86. <std><offset>[<dst>[<offset>],<start>[/<time>],<end>[/<time>]]
  87.  
  88. Where:
  89.  
  90. <std> and <dst>
  91.     Are each three or more bytes that are the designation for the
  92.     standard (<std>) and daylight savings time (<dst>) timezones.
  93.     Only <std> is required - if <dst> is missing, then daylight
  94.     savings time does not apply in this locale.  Upper- and
  95.     lower-case letters are allowed.  Any characters except a
  96.     leading colon (:), digits, a comma (,), a minus (-) or a plus
  97.     (+) are allowed.
  98.  
  99.     **CLARIFICATION**  The two-byte designation `UT' is permitted.
  100.  
  101. <offset>
  102.     Indicates the value one must add to the local time to arrive
  103.     at Coordinated Universal Time.    The offset has the form:
  104.     <hh>[:<mm>[:<ss>]]
  105.  
  106.     The minutes <mm> and seconds <ss> are optional.  The hour <hh>
  107.     is required and may be a single digit.    The offset following
  108.     <std> is required.  If no offset follows <dst>, daylight savings
  109.     time is assumed to be one hour ahead of standard time.    One or
  110.     more digits may be used; the value is always interpreted as a
  111.     decimal number.  The hour must be between 0 and 24, and the
  112.     minutes (and seconds) if present between 0 and 59.  Out of
  113.     range values may cause unpredictable behavior.    If preceded by
  114.     a `-', the timezone is east of the Prime Meridian; otherwise
  115.     it is west (which may be indicated by an optional preceding
  116.     `+' sign).
  117.  
  118.     **CLARIFICATION**  No more than two digits are allowed in any
  119.     of <hh>, <mm> or <ss>.    Leading zeros are permitted.
  120.  
  121. <start>/<time> and <end>/<time>
  122.     Indicates when to change to and back from daylight savings
  123.     time, where <start>/<time> describes when the change from
  124.     standard time to daylight savings time occurs, and
  125.     <end>/<time> describes when the change back happens.  Each
  126.     <time> field describes when, in current local time, the change
  127.     is made.
  128.  
  129.     **CLARIFICATION**  It is recognized that in the Southern
  130.     hemisphere <start> will specify a date later than <end>.
  131.  
  132.     The formats of <start> and <end> are one of the following:
  133.  
  134.     J<n>    The Julian day <n> (1 < <n> < 365).  Leap days are not
  135.         counted.  That is, in all years, February 28 is day 59
  136.         and March 1 is day 60.    It is impossible to refer to
  137.         the occasional February 29.
  138.  
  139.     <n>    The zero-based Julian day (0 < <n> < 365).  Leap days
  140.         are counted, and it is possible to refer to February
  141.         29.
  142.  
  143.     M<m>.<n>.<d>
  144.         The <d>th day, (0 < <d> < 6) of week <n> of month <m>
  145.         of the year (1 < <n> < 5, 1 < <m> < 12), where week 5
  146.         means `the last <d>-day in month <m>' (which may occur
  147.         in either the fourth or the fifth week).  Week 1 is
  148.         the first week in which the <d>th day occurs.  Day
  149.         zero is Sunday.
  150.  
  151.         **CLARIFICATION**  Neither <n> nor <m> may have a
  152.         leading zero.  <d> must be a single digit.
  153.  
  154.         **CLARIFICATION**  If <dst> is given then <start>
  155.         and <end> are required - there is no `implementation
  156.         specific default'.
  157.  
  158.     <time> has the same format as <offset> except that no leading
  159.     sign (`-' or `+') is allowed.  The default, if <time> is not
  160.     given is 02:00:00.
  161.  
  162.     **CLARIFICATION**  The number of hours in <time> may be up
  163.     to 167, to allow encoding of rules such as `00:00hrs on the
  164.     Sunday after the second Friday in September'
  165.  
  166.  
  167. Legal Stuff:
  168. ------------
  169.  
  170. There is no warranty. ClockDaemon is Freeware.
  171.  
  172. Credits:
  173. --------
  174.  
  175. I borrowed the timezone string description from another package
  176. (SetTZ or TZSet or something like that). Anyway, a big "thank you"
  177. to the author.
  178.  
  179. The idea to run a script at DST start/end came from Henning Hucke.
  180.  
  181. And finally, a big "Thank You !" to Steve, Doug and Jim at SAS.
  182.  
  183. History:
  184. --------
  185.  
  186. Version 1.0: Not released.
  187.  
  188.         1.1: Added ixemul V 42 support.
  189.  
  190.         1.2: Added DSTCHANGECOMMAND.
  191.              Added detection of DST start/end while computer is on.
  192.              Added DSTCheck command.
  193.  
  194. Bug reports & suggestions:
  195. --------------------------
  196.  
  197. Send bug reports & suggestions to pueschel@imsdd.meb.uni-bonn.de.
  198.  
  199.  
  200. ============================= Archive contents =============================
  201.  
  202. Original  Packed Ratio    Date     Time    Name
  203. -------- ------- ----- --------- --------  -------------
  204.     3892    2350 39.6% 06-Apr-96 18:30:56  ClockDaemon
  205.     6178    2790 54.8% 06-Apr-96 18:50:06  clockdaemon.readme
  206.      212     197  7.0% 05-Apr-96 16:46:30  DSTCheck
  207. -------- ------- ----- --------- --------
  208.    10282    5337 48.0% 08-Apr-96 17:24:42   3 files
  209.